主题
文件模块总览 - Overview
本分类做什么
提供 目录与文件 的创建、删除、枚举、复制移动、重命名、存在性判断，以及 路径规范化 与 文本/二进制读写。与 日志 落盘路径配合时，注意 编码与换行（各读写接口见详情页）。
一、目录 vs 文件
| 操作 | 目录接口 | 文件接口 |
|---|---|---|
| 创建 | CreateFolder | CreateFile |
| 删除 | DeleteFolder | DeleteFile |
| 存在 | IsDirectory、FileOrDirectoryExists | IsFile |
| 枚举 | GetFolderList | GetFileList |
差异：FileOrDirectoryExists 二合一；IsFile/IsDirectory 类型明确。
二、复制、移动、重命名
| 接口 | 差异 |
|---|---|
| CopyFile | 保留源，生成副本。 |
| MoveFile | 同盘/跨盘行为以 OS 与详情页为准。 |
| RenameFile | 仅改名或同目录重命名（见详情页）。 |
三、路径
| 接口 | 用途 |
|---|---|
| ToAbsolutePath | 相对 → 绝对。 |
| ToRelativePath | 绝对 → 相对（需基准路径参数，见详情页）。 |
四、内容与二进制
| 接口 | 差异 |
|---|---|
| ReadFileString | 按 文本 读（编码见详情页）。 |
| ReadBytesFromFile | 原始字节。 |
| WriteStringToFile | 写 文本。 |
| WriteBytesToFile | 写 二进制。 |
选型：配置文件、JSON → String；字库 bin、图片 → Bytes。
五、元信息
| 接口 | 说明 |
|---|---|
| GetFileSize | 字节长度。 |
| GetFileName | 从路径取 文件名（不含目录）。 |
六、快速选型
| 需求 | 建议 |
|---|---|
| 遍历目录下所有 png | GetFileList + 后缀过滤 |
| 相对脚本目录读配置 | ToAbsolutePath 再 ReadFileString |
| 大文件分块 | 若插件无分块 API，需自行 ReadBytesFromFile 偏移策略（见版本是否支持） |